focusColor

Type

property

Summary

Specifies the color of the outline around the active control or the field with the insertion point.

Syntax

set the focusColor of <object> to {empty | <colorName> | <RGBColor>}

Description

Use the focusColor property to specify the outline color of an object when it's active.

Setting the focusColor of an object to empty allows the focusColor of the object's owner to show through. Use the effective keyword to find out what color is used for the object, even if its own focusColor is empty.

If the focusColor is not set for any object in the object hierarchy, the system setting is used.

The setting of the focusColor property has different effects, depending on the object type:

• The focusColor of a stack, card, or group determines the focusColor of each object in the stack, card, or group that does not have its own focusColor.

• The focusColor of a button is used to outline the button when it is focused. If the button's style is menu, or if the button's traversalOn property is false, the focusColor has no effect.

• The focusColor of a field or scrollbar is used to outline the object when it is focused. If the object's traversalOn property is false, the focusColor has no effect.

• The focusColor of a graphic, player, audioClip, videoClip, or EPS object has no effect.

• The focusColor of an image is the eighth color in the image's color palette.

If an object's focusPattern is set, the pattern is shown instead of the color specified by the focusColor.

The focusColor property has no effect on controls whose showFocusBorder property is set to false.

If the lookAndFeel is set to "Macintosh" or "Appearance Manager", the focusColor affects only fields.

Examples

set the focusColor of me to "black"

set the focusColor of button "Help" to 128,128,255

Related

glossary: object, property, color palette, focus, active control, hexadecimal, integer, keyword, object hierarchy, color reference, insertion point, object type, EPS

keyword: effective, card, button, player, graphic, scrollbar, field, image

object: audioClip, button, stack, videoClip

property: style, owner, traversalOn, showFocusBorder, focusColor

command: focus, group

Compatibility and Support

Introduced

LiveCode 1.0

OS

mac

windows

linux

ios

android

Platforms

desktop

server

mobile